home *** CD-ROM | disk | FTP | other *** search
/ Games of Daze / Infomagic - Games of Daze (Summer 1995) (Disc 1 of 2).iso / x2ftp / msdos / wgt / wgt5 / readme < prev    next >
Encoding:
Text File  |  1995-06-02  |  6.3 KB  |  163 lines
  1.  
  2.                         WGT 5.0 for Watcom C/C++ 10.0
  3.                                  DEMO VERSION
  4.                              by Egerter Software
  5.  
  6. This release of WGT 5.0 is for DEMO purposes only and may not be used for
  7. profit in any way.  It contains a limited set of instructions and a lack of
  8. documentation.  Example files which cannot be compiled with this reduced
  9. version have been provided in an executable form.
  10.  
  11. Additional features found in commercial version:
  12. ------------------------------------------------
  13. - 9 other library files including sprite animation, 3d math, drop-down
  14.   menus, scrolling engine, joystick commands, FLI/FLC animation routines,
  15.   file selector, serial communications, VESA SVGA system
  16. - full source code for 3d rendering engine, drop-down menu library,
  17.   scrolling engine, sprite library, communications library and GIF routines
  18. - 3.6 megabyte graphics and sound demo (called FLIGHT) written with
  19.   WGT 5.0 for an international competition (the demo won 3rd place)
  20. - shareware version of a 32-bit protected mode digital sound system for
  21.   playing music and mixing sound effects real-time (DSIK 2.0)
  22. - license agreement
  23. - printed 405 page manual including:
  24.         a) Programmer's Guide
  25.         b) Sprite Editor
  26.         c) Map Maker
  27.         d) Reference manuals for all 10 libraries
  28.         e) Printed source code for scrolling library, menu library,
  29.            sprite library and 3d rendering engine
  30.  
  31. To order, please fill out the enclosed ORDER.TXT file and send proper payment
  32. (instructions are on the form). Orders will be shipped via courier for
  33. customers outside of Canada and via Canada Post otherwise.
  34.  
  35. ******************************************************************************
  36. Installing the Software
  37. -----------------------
  38.  
  39. At the DOS prompt, type INSTALL and the installation program will begin.
  40. This program will copy all or part of the toolkit to your hard drive.
  41. It will create a directory called WGT5 in the root directory. Each part of
  42. the toolkit will have a subdirectory in the WGT5 directory.
  43.  
  44. Follow the on-screen prompts to complete the installation.
  45.  
  46. This DEMO version contains the following areas:
  47.  
  48. ******************************************************************************
  49. Making Example Files
  50. --------------------
  51.  
  52.         If an executable version of a source code file is not present, then
  53. you must build one using the included batch files. Most batch files can simply
  54. be run to produce the EXE, but the MAKE.BAT in the WGT5\EXAMPLES must be used
  55. as:     MAKE wgt04       or     MAKE wgt12  for example.
  56.  
  57. Files in the main example directory are numbered from 01 to 70. There is one
  58. exception to this rule, because WGT68 has its own directory and contains 5
  59. versions of the program.
  60.  
  61. ******************************************************************************
  62. **** ATTENTION WGT 4.0 Users ****
  63.     Major Changes from WGT 4.0
  64. =================================
  65.  
  66. New structures:
  67.  
  68. extern struct {
  69.   short xres;                   /* Horizontal screen resolution          */
  70.   short yres;                   /* Vertical screen resolution            */
  71.   short videomode;              /* Current videomode                     */
  72.   int   videobanksize;          /* Size of memory bank (VESA)            */
  73.   short (*bankswitch)(short);   /* Pointer to bank switch routine (VESA) */
  74. } WGT_SYS;
  75.  
  76.         This structure contains a few important statistics which can be
  77. read by the user. DO NOT change these variables yourself. VIDEOMODE does
  78. not change when using wsetmode, only with vga256 and wvesa_init.
  79.  
  80.  
  81.  
  82. typedef struct {
  83.   short but;                    /* Mouse button being pressed  */
  84.   short mx;                     /* Horizontal mouse coordinate */
  85.   short my;                     /* Vertical mouse coordinate */
  86. } callback_data;
  87. extern callback_data mouse;
  88.  
  89.         All mouse variables are now found within this structure. 
  90.  
  91.  
  92.  
  93.         The scrolling library has been dramatically altered. Many routines
  94. now use different parameters.  The basic command order has been maintained
  95. but should be verified against the new examples.
  96.  
  97. ******************************************************************************
  98. CONVERTING TURBO/BORLAND C PROGRAMS TO WATCOM
  99.  
  100. To convert previous WGT programs to Watcom, simply do a search and replace on:
  101.  
  102. Search for              Replace with            *** Order is important!
  103. ==========              ============
  104. int                     short
  105. long                    int
  106. but                     mouse.but
  107. mx                      mouse.mx
  108. my                      mouse.my
  109.  
  110. far                     NOTHING (remove all FAR references in code)
  111.  
  112.  
  113.  
  114. Functions Which Have Been Eliminated:
  115. =====================================
  116.  
  117. All EMS functions
  118. All SB routines
  119. wdetectcpu
  120.  
  121. ******************************************************************************
  122.  
  123. Library File Changes:
  124. =====================
  125.  
  126. All library files have been renamed to include WC indicating Watcom.
  127.  
  128. WFLIC_WC.LIB   -now uses memory instead of EMS, so check the include file
  129.                 for variable names and defines
  130.  
  131. Old name                        New Name
  132. ********                        ********
  133. WGT4.LIB                        WGT5_WC.LIB
  134. WSPR.LIB                        WSPR_WC.LIB
  135. WGTJOY.LIB                      WJOY_WC.LIB
  136. WGTSCROL.LIB                    WSCR_WC.LIB
  137. WGT3D.LIB                       WGT3D_WC.LIB
  138. WFILE.LIB                       WFILE_WC.LIB
  139. WGTMENU.LIB                     WMENU_WC.LIB
  140. WGTFLIC.LIB                     WFLIC_WC.LIB
  141. WGTVESA.LIB                     WVESA_WC.LIB
  142.  
  143.  
  144. ******************************************************************************
  145.  
  146. Other Notes
  147. ===========
  148.  
  149. - wsetscreen now works with ANY block. Clipping variables are set to match
  150.   the image dimensions.
  151.  
  152. - many DOS and BIOS functions use different structures and parameters than
  153.   the Turbo/Borland versions. Be sure to check the manuals when trying to
  154.   find compatibility errors (compiler warnings).
  155.  
  156. - All image loading functions are capable of handling ANY size picture as
  157.   long as the machine has enough memory to hold it. Our machines have
  158.   8 megs of RAM and therefore a 2900x2900 pixel image is out of reach, but
  159.   a 2800x2800 pixel image is possible (as long as program size is small :)
  160.  
  161.  
  162.  
  163.